home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 13 / Mac Magazin and MacEasy Magazine CD - Issue 13.iso / Musik / Midi It! Folder / About Midi It! next >
Text File  |  1995-07-29  |  12KB  |  236 lines

  1. About “MidiIt”
  2.  
  3. Revision:    1.2.1
  4. Issued Date:    August 28, 1994
  5. Modified Date:    July 29, 1995
  6. Publisher:    Fumio Rokkaku
  7.  
  8.  
  9. 1. What is “Midi It!”?
  10.  
  11.  “Midi it!” is a Macintosh utility which changes the file type and creator of a standard MIDI file so the file can be used by your sequencer. You can change selected files or all files in a folder by dragging and dropping them onto the “Midi It!” icon. If a file is not a standard MIDI file, it will not be changed.
  12.  
  13.  I guess the scene “Midi It!” can participate most actively is when you import Standard MIDI Files from DOS using a tool such as Apple File Exchange, or, when you download Standard MIDI Files through computer network that were created other machines than Macintosh.
  14. w
  15.  In those cases, the file types of the files may be set to 'TEXT' or 'BINA' and average sequencer program for Macintosh can’t read them. The file type of Standard MIDI Files is defined as 'Midi' and other types aren’t recognized even the files' contents are correctly constructed as Standard MIDI Files format. In such cases, you may just set the types to 'Midi'.
  16.  
  17.  It's simple answer but how do you change the type actually? You’ve already had several solutions.
  18.  
  19. 1) Use ResEdit, open the file using “Get File Info” menu, and set the type to 'Midi'.
  20. 2) Use general purpose type changing utilities such as File Typer.
  21. 3) Use Standard MIDI Files specific type changing utilities such as MIDI File Converter.
  22.  
  23.  I haven’t been satisfied, however, with any of those ways.
  24.  
  25. 1) ResEdit requires too many procedures and it is dangerous when I wrongly operate them.
  26. 2) General purpose utilities change any files to 'Midi', even though the files are totally different from Standard MIDI files.
  27. 3) That's the same on the dedicated utilities. Some of them recognize extension mark of “.MID” as 'Midi' but it doesn't allow me to name files freely and it’s not likely Macintosh style.
  28.  
  29.  At last, I decided to write my own program that checks the file is really a Standard MIDI File before changing the file type.
  30.  
  31.  That’s the “Midi It!”.
  32.  
  33.  
  34. 2. How to use it?
  35.  
  36. 2.1. Drag and Drop
  37.  
  38.  If you use System 7, you can use “Midi It!” by common “Drag and Drop” operation.
  39.  Just drag and drop your Standard MIDI file onto “Midi It!” icon on the Finder screen. Then “Midi It!” will read the file, checks the contents of the file and changes the file type.
  40.  When it recognizes the file is Standard MIDI file format, it shows file Info. and asks you to go ahead. If you hit OK button, then it really changes the file type.
  41.  
  42.  It also can catch a folder dropping. At this case, “Midi It!” checks all the file in the folder and if it finds Standard MIDI Files, change the types of them.
  43.  
  44.  “Midi It!” checks the dropped file whether if it’s a Standard MIDI file beforehand. You won’t get a wrongly converted file even if you drop other type of files. (The author has tried to write “Midi It!” to do so. In case it failed, please let me know how it went wrong.)
  45.  
  46.  From the version 1.2, “Midi It!” applies Macintosh Drag and Drop. Try dropping files or folders directly to the “Open” button. (It requires System 7.5 or greater.)
  47.  
  48.  
  49. 2.2. Press “Open” button on the button window
  50.  
  51.  You can select files using “Open” button. You will see a file select dialog and , using this, you can select any files or folders. When you choose a locked file, you can unlock using a checkbox below the “Open” button in the file select dialog.
  52.  
  53. 2.3. Select “Open...” of the “File” menu
  54.  
  55.  This operation is identical to the “Open” button.
  56.  You can also use “Command + O” shortcut. You can even abbreviate just pressing “O” key.
  57.  
  58.  
  59. 3. Are there any options?
  60.  
  61. 3.1. English/Japanese language sets
  62.  
  63.  “Midi It!” was born in Japan. It is natural that is has Japanese messages as well as English ones.
  64.  You can select one of those using “Language” menu.
  65.  However, if you haven't installed Japanese System such as KanjiTalk or Japanese Language Kit from Apple®, you can't get Japanese messages.
  66.  
  67. 3.2. Optional Behaviors
  68.  
  69.  “Midi It!” offers you five kinds of option. To choose those options, open “Preferences” window by pressing the “Prefs” button or “Open Preferences” in the “Preferences” menu. You can select options in the window using dedicated check boxes.
  70.  
  71. 3.2.1. Open dialog on double-click startup
  72.  It is a switch to let “Midi It!” open the file select dialog on startup.
  73.  If it is set to on, “Midi It!” immediately shows file select dialog.
  74.  
  75. 3.2.2. Show SMF Info. before changing type
  76.  If it is set to on, “Midi It!”  shows Standard Midi File Info before changing file type and asks you to change it.
  77.  It may make you feel safe and comfortable to see this information before changing a file.
  78.  If you don’t want to have to hit the “OK” button each time, then turn off this function.
  79.  
  80. 3.2.3. Remain after drag & drop
  81.  It sets “Midi It!” to remain after “drag and drop” operation.
  82.  If it is set to on, it stays after type-changing. Otherwise, it quits immediately.
  83.  
  84. 3.2.4. Sound effects on during change
  85.  If it is set to on, “Midi It!” lets you know when it finished the changing procedure by playing a bell sound.
  86.  If this is annoying, set it to off.
  87.  
  88. 3.2.5. Use left cursor
  89.  You can choose right or left cursor.
  90.  Frankly speaking, I don’t have any real reason for implementing this other than personal desire.
  91.  
  92. 3.3. Default Application
  93.  
  94.  “Midi It!” does not change only a file type but also a file creator that represents which application has created the file. Utilizing this signature, you can launch the application you always use just by double-clicking the type-changed file.
  95.  
  96.  I’ve already register two applications I purchased, Vision™ and Performer™. You can add other applications as you like up to 10 kinds. 
  97.  
  98. 3.3.1. Registering a new application.
  99.  Choose an empty button and double-click it or choose the “New Application...” item of “Preferences” menu.
  100.  Then the file select dialog will appear. Please select your application to register.
  101.  You will see the application icon on the button when registration is successfully done.
  102.  From the version 1.2, you can drag and drop applications directry onto the button.
  103.  
  104. 3.3.2. Removing a registered application.
  105.  When you want to removed a registered application, choose the button of the application and select the “Cut” or “Clear” item of the “Edit”. You can also use the “Command + X” or “Delete Key” shortcuts.
  106.  
  107. 3.3.3. Changing the default application
  108.  I think you don’t need further explanation. Just click an application button you want to select. The button’s color will change to green.
  109.  Next time you change the file type, the creator will also be changed as you designate.
  110.  
  111. 3.3.4. Launching the registered application.
  112.  You can launch the registered application from “Midi It!”.
  113.  Double-click an icon of the registered application or select the “Launch” item of File menu.
  114.  
  115.  Those are all of the options of “Midi It!”.
  116.  
  117.  
  118. 4. On what Macintosh does it works?
  119.  
  120.  “Midi It!” works on Macintosh Plus or greater. 
  121.  Up to version 1.0.1, “Midi It!” needs color QuickDraw but, from version 1.0.2, it can run on Macintosh Plus even without the color environment.
  122.  From version 1.2, “Midi It!” becomes a FAT application. Now it’s fully compatible to PowerMacintosh. Instead, it only supports System 7 or greater since it is too hard to catch up the latest technology while supporting old versions. Hence “Midi It!” no longer runs under Systen 6, sorry.
  123.  
  124.  
  125. 5. How much do I pay for it?
  126.  
  127.  “Midi It!” is a freeware program. You can use it without any charge.
  128.  You can also copy it and distribute it for personal use without permission of the author.
  129.  
  130.  Note that the author reserves all copyrights of “Midi It!”. Under the copyright laws, the author prohibits the following manners.
  131.  
  132. • To use “Midi It!” for commercial purposes such as selling and lending without the author’s permission.
  133. • To modify or revise “Midi It!” without the author’s permission.
  134.  
  135. The author’s request:
  136.  If you distribute “Midi It!” through a commercial network, please inform the author either beforehand or afterwards.
  137.  If you wish to include “Midi It!” into a CD-ROM disc for selling, please contact the auther beforehand. The author will basically agree with your request.
  138.  If you wish to include “Midi It!” in your software package as a help utility, the author will agree with you as far as you are responsible to any kinds of problem from the market.
  139.  Attach always this document when you distribute “Midi It!”.
  140.  
  141. The author does not require any compensations when you use “Midi It!”. However, any of returning thanks will be appreciated. E-Mails, post cards or any tiny gifts will greatly encourage the author.
  142.  
  143.  
  144. 6. Where to send requests or bug reports
  145.  
  146.  Please send your messages to the following address via E-Mail or traditional mail.
  147.  
  148. E-Mail Address:
  149.     Internet:    rokkaku@roland.co.jp
  150.     NIFTY-Serve:    PXL01437@niftyserve.or.jp
  151.  
  152. Posting Address:
  153.     Fumio Rokkaku
  154.     1158-3-106, Hatsuoi-cho
  155.     Hamamatsu, Shizuoka
  156.     JAPAN    Postal Code 433
  157.  
  158.  
  159. 7. Technical information
  160.  
  161. 7.1. Standard MIDI File Format and Info.
  162.  “Midi It!” recognizes Standard MIDI File Format 0 and Format 1. Regarding the “Standard MIDI Files Info” when you drop a Format 1 file, the “Midi It!” searches only within Sequence Track 1. You won’t see any info of other tracks.
  163.  
  164. 7.2. Locked File
  165.  “Midi It!” will change the file type and creator of locked files. This may violate the Apple Human Interface Guideline but I have reasons to do so. Before arresting me, please give me a chance to explain why I wrote this way.
  166.  
  167.  First, it doesn’t modify any contents of the file.
  168.  Second, I think it’s too annoying for the users to unlock files just to change the type; I even think it’s unreasonable.
  169.  In most cases, locked files come from commercial-based DOS format disks. These merchandise data are set to Read-Only permission because of the copyright protection. Apple File Exchanger automatically sets lock bits on such files when it copies from DOS disks. Do the Read-Only permission on DOS and Lock Bit on Macintosh have exactly the same meaning?
  170.  All the user wants is to listen to the data on Macintosh. For this purpose, the user uses the Apple File Exchange, then realizes his or her sequencer doesn’t read the files, so he or she tries to change the type and is warned that “the file is locked”. Then the user selects the file and opens the Get Info window and unlock the file. Finally, the type can be changed.
  171.  I think trying to eliminate this hassle is permissable. Of cause “Midi It!” restores these files to their locked status.
  172.  
  173.  I decided to ignore the lock bit because of the aforementioned reasons. I couldn’t make Finder stop its warning before passing the file over to “Midi It!”.
  174.  
  175.  
  176. 7.3. Development Environments
  177. Machine:    Macintosh IIvx with System 7.5.1 and Japanese Language Kit
  178. Language:    Metrowerks C/C++ 1.2.2
  179.  
  180. 8. Other comments
  181.  
  182.  The auther works at Roland Corporation which is somewhat related to Standard MIDI Files. “Midi It!” is, however, a totally independent program from Roland Corporation.
  183.  The auther wrote the program using his own private funds, equipment and time. All the copyrights and the related property rights are reserved by the author.
  184.  Please ask or request regarding “Midi It!” directly to the author. Please don’t ask to Roland Corporation instead.
  185.  
  186.  
  187. 9. Revision history
  188.  
  189. Version 1.0:    August 28 1994
  190.     The first release.
  191.  
  192. Version 1.0.1:    September 3 1994
  193.     Minor revise such as update procedure while modal dialog.
  194.  
  195. Version 1.0.2:    September 15 1994
  196.     Now Midi It! runs on Macintosh Plus or greater.
  197.  
  198. Version 1.0.3:    September 20 1994
  199.     Fixed a bug occurs on Preference Window when chaning language.
  200.     Quickened window redrawing under System 6.
  201.  
  202. Version 1.2:    July 22, 1995
  203.     Now it's FAT Application.
  204.     Now it's Macintosh Drag & Drop applicable.
  205.     Now it can launch applications.
  206.     Changed Finder icons.
  207.  
  208. Version 1.2.1:    July 29 1995
  209.     Fixed grow icon problem in the Preferences dialog while using Copland WDEF.
  210.     Avoided using Chicago font in the SMF Info dialog when displaying Japanese.
  211.     Corrected errors of this document.
  212.  
  213.  
  214. 10. Special thanks
  215.  
  216.  I would like to express my thanking to the following persons. They greatly helped me when developing and releasing “Midi It!”.
  217.  
  218. Technical Advises:
  219.     Takahiro Sumiya (sumi@cuby.mis.hiroshima-u.ac.jp)
  220.  
  221. Debugging:
  222.     Shun Takai (takai@roland.co.jp)
  223.     Adrian Scott
  224.  
  225. Spec. Suggestions:
  226.     Keiji Satoh    (sato@abiko.denken.or.jp)
  227.  
  228. English Correction:
  229.     Charles Kelly    (ckelly@aitech.ac.jp)
  230.  
  231.  
  232. 11. Copyright notice
  233.  
  234. Midi It! ©1994-1995 Fumio Rokkaku
  235. All Rights Reserved.
  236.